package com.ruoyi.business.service;

import com.baomidou.mybatisplus.extension.service.IService;
import com.ruoyi.business.domain.VisitorRecords;
import com.ruoyi.business.param.VisitorCountXmlParam;
import com.ruoyi.business.vo.VisitDataVO;
import com.ruoyi.business.vo.VisitorCountVo;
import com.ruoyi.business.vo.VisitorRecordsExportVo;

import java.util.List;

/**
 * 访客记录Service接口
 * 
 * @author qiancheng
 * @date 2025-06-13
 */
public interface IVisitorRecordsService extends IService<VisitorRecords>
{
    /**
     * 查询访客记录
     * 
     * @param id 访客记录主键
     * @return 访客记录
     */
    public VisitorRecords selectVisitorRecordsById(Long id);

    /**
     * 查询访客记录列表
     * 
     * @param visitorRecords 访客记录
     * @return 访客记录集合
     */
    public List<VisitorRecords> selectVisitorRecordsList(VisitorRecords visitorRecords);

    /**
     * 新增访客记录
     * 
     * @param visitorRecords 访客记录
     * @return 结果
     */
    public int insertVisitorRecords(VisitorRecords visitorRecords);

    /**
     * 修改访客记录
     * 
     * @param visitorRecords 访客记录
     * @return 结果
     */
    public int updateVisitorRecords(VisitorRecords visitorRecords);

    /**
     * 批量删除访客记录
     * 
     * @param ids 需要删除的访客记录主键集合
     * @return 结果
     */
    public int deleteVisitorRecordsByIds(Long[] ids);

    /**
     * 删除访客记录信息
     * 
     * @param id 访客记录主键
     * @return 结果
     */
    public int deleteVisitorRecordsById(Long id);

    /**
     * 首页->>访问数据->>获取访客数据统计信息
     * @param visitorRecords
     * @return
     */
    public VisitDataVO getVisitStatistics(VisitorRecords visitorRecords);

    /**
     * 首页->>访问数据->>更多->>根据年月周获取每天访问人数
     * @param VCountXmlParam
     * @return
     */
    VisitorCountVo getCountByDate(VisitorCountXmlParam VCountXmlParam);

    /**
     * 首页->>访问数据->>更多->>根据年月周获取每天访问列表
     * @param VCountXmlParam
     * @return
     */
    public List<VisitorRecords> getListByDate(VisitorCountXmlParam VCountXmlParam);

    /**
     * 根据年月周导出访客记录列表
     * @param VCountXmlParam
     */
    public List<VisitorRecordsExportVo> getListByDateExport(VisitorCountXmlParam VCountXmlParam);

}
